Delete Endpoints

Route

/v2/endpoints

Description

Remove endpoints (sensors) from Cyberhaven management. This operation permanently removes the endpoint from the platform and cannot be undone.

Method

DELETE

Inputs

Parameter	Type	Required	Description
ids	array[string]	Yes	Array of endpoint IDs to delete (max 100)

Request Example

{
  "ids": ["endpoint-123", "endpoint-456", "endpoint-789"]
}

Output

Field	Type	Description
deleted_count	integer	Number of endpoints successfully deleted
errors	array[Error]	Any errors encountered during deletion

Error Object Structure

Field	Type	Description
endpoint_id	string	ID of endpoint that failed to delete
code	string	Error code identifier
message	string	Human-readable error description

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response

{
  "deleted_count": 2,
  "errors": [
    {
      "endpoint_id": "endpoint-789",
      "code": "ENDPOINT_NOT_FOUND",
      "message": "Endpoint not found or already deleted"
    }
  ]
}